SAGE II SYSTEM RELEASE NOTES 

September 1982 

The System Release Notes present information which is subject to 
change or specific to a shipment. The directories of the 
distribution diskettes are presented here along with a growing set 
of information on Terminal configuration files. Also contained in 
the System Release Notes is a list of problems and restrictions 
which are currently outstanding in the software. 

DISKETTE FILES: 



The files for 80 track (96 TPI) systems are contained on two 
diskettes called SYSTEM: and UTILITY:. The diskette SYSTEM: is 
bootable on the SAGE II computer. It contains all the critical 
files for running the UCSD p-System. The diskette UTILITY: contains 
p-System utility files as well as other SAGE provided software. 

For 40 track (48 TPI) systems, the bootable diskette is also called 
SYSTEM:. The less critical system files are contained on the 
diskette called UTILl:. The remaining utilities and SAGE provided 
software are contained on the diskette UTIL2 : . 



Directories for 80 track distribution, 



SYSTEM: 












SYSTEM. PASCAL 


119 


13-Jun-82 


10 


512 


Dataf ile 


SYSTEM. MISCINFO 


1 


l-Sep-82 


129 


226 


Dataf ile 


USERLIB.TEXT 


4 


13-Sep-82 


130 


512 


Textf ile 


SYSTEM. LIBRARY 


7 


13-Sep-82 


134 


512 


Dataf ile 


SYSTEM. SYNTAX 


14 


18-May-82 


141 


512 


Textf ile 


SYSTEM. FILER 


38 


27-May-82 


155 


512 


Codefile 


SYSTEM. EDITOR 


47 


7-Jun-82 


193 


512 


Codef ile 


SYSTEM. COMPILER 


108 


7-Apr-82 


240 


512 


Codefile 


SETUP. CODE 


36 


14-Apr-82 


348 


512 


Codefile 


SAGEUTIL.CODE 


46 


8-Sep-82 


384 


512 


Codefile 


LIBRARY. CODE 


13 


l-Apr-82 


430 


512 


Codefile 


SAGEDATE.CODE 


5 


30-Aug-82 


443 


512 


Codefile 


ENDBOOT 


1 


13-Sep-82 


448 


512 


Dataf ile 


SYSTEM. BIOS 


20 


13-Sep-82 


449 


512 


Codefile 


SYSTEM. INTERP 


20 


13-Sep-82 


469 


512 


Codefile 


SAGETOOLS.CODE 


51 


13-Sep-82 


489 


512 


Codefile 


YALOE.CODE 


12 


22-Apr-82 


540 


512 


Codefile 


SAMPLEGOTO.TEXT 


6 


17-Jul-82 


552 


512 


Textf ile 


SCREENOPS.CODE 


8 


26-Apr-82 


558 


512 


Codefile 


SCREENTEST.CODE 


13 


27-May-82 


566 


512 


Codefile 


COPYDUPDIR.CODE 


3 


7-Apr-82 


579 


512 


Codefile 
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SYSTEM: ••continued. ( or UTILl: on 40 track diskettes) 



SYSTEM. ASSMBLER 56 18-May- 

68000. OPCODES 4 18-Jan- 

68000. ERRORS 9 18-Jan- 

SYSTEM. LINKER 27 1-Apr- 

DECODE.CODE 28 1-Apr- 

PATCH.CODE 39 18-May 

XREF.CODE 28 1-Apr- 

COMPRESS.CODE 10 24-May- 

REALCONV.CODE 4 25-Mar- 

MARKDUPDIR.CODE 4 7-Apr- 

BOOTER.CODE 3 18-May- 

INTERP.0.CODE 17 13-Sep- 

INTERP.2.CODE 20 13-Sep- 

INTERP.4.CODE 22 13-Sep- 

REALOPS.2.CODE 10 1-Apr- 

REALOPS.4.CODE 12 1-Apr- 

ANSI.CODE 14 7-Jun- 

ANSIGOTOXY.CODE 3 1-Apr- 

ANSI.MISCINFO 1 1-Sep- 

VT52.MISCINFO 1 31-Aug- 

VT5 2. GOTO. CODE 3 31-Aug- 

TV925. GOTO. CODE 3 16-Aug- 

TV925.MISCINFO 1 1-Sep- 

H19.MISCINFO 1 1-Sep- 

IQ120.MISCINFO 1 7-Sep- 

TV912.MISCINFO 1 7-Sep- 

COMMANDIO.CODE 3 26-Apr- 

DIR, INFO. CODE 18 1-Apr- 

DISKCHANGE.CODE 8 18-May- 

DISKSIZE.CODE 3 18-May- 

ERRORHANDL.CODE 3 27-May- 

FILE. INFO. CODE 7 1-Apr- 

FINDPARAMS.CODE 9 7-Apr- 

RECOVER.G.CODE 8 7-Apr- 

SYS. INFO. CODE 5 1-Apr- 

WILD.CODE 6 1-Apr- 

KERNEL.CODE 30 26-Apr- 

S AGE. PBOOT. CODE 4 17-Aug- 

SAGE.PBOOT.TEXT 38 17-Aug- 

< UNUSED > 234 
60/60 files<listed/in-dir>, 



•82 582 

■82 638 

■82 642 

■82 651 

•82 678 

■82 706 

•82 745 

■82 773 

■82 783 

■82 787 

■82 791 

■82 794 

•82 811 

■82 831 

■82 853 

■82 863 

•82 875 

■82 889 

•82 892 

•82 893 

•82 894 

■82 897 

•82 900 

■82 901 

•82 902 

•82 903 

■82 904 

•82 907 

82 925 

82 933 

82 936 

82 939 

82 946 

82 955 

82 963 

82 968 

82 974 

82 1004 

82 1008 
1046 
1046 blocks 



512 
120 
272 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
226 
226 
512 
512 
226 
226 
226 
226 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 



Codefile 
Dataf ile 
Dataf ile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Dataf ile 
Dataf ile 
Codefile 
Codefile 
Dataf ile 
Dataf ile 
Dataf ile 
Dataf ile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Textfile 



used, 234 unused, 

234 in largest 
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UTILITY: (or UTIL2: on 40 track diskettes) 



IB. EX. CODE 

IB.LNK.CODE 

IB. UNIT. CODE 

IB. UNIT. TEXT 

IB. EX. TEXT 

IB.DEF.TEXT 

RECEIVE. CODE 

REMINTEST.CODE 

REMOUTTEST.CODE 

REMTALK.CODE 

SEND. CODE 

TEXTIN.CODE 

RECEIVE. TEXT 

REMINTEST.TEXT 

REMOUTTEST.TEXT 

SEND. TEXT 

TEXTIN.TEXT 

FORTRAN2.CODE 

FORTRAN4.CODE 

FORTLIB2.CODE 

FORTLIB4.CODE 

BLIB.R2.CODE 

BLIB.R4.CODE 

BASIC. R4. CODE 

BASIC. R2. CODE 

REMTALK.TEXT 

IB. BUS. TEXT 

< UNUSED > 

28/28 files<list 



2 13-Sep-82 15 
9 13-Sep-82 17 
8 13-Sep-82 26 

18 13-Sep-82 34 

8 13-Sep-82 52 

16 13-Sep-82 60 

3 16-Jul-82 76 
2 16-Jul-82 79 

2 16-Jul-82 81 
6 18-May-82 83 

3 16-JU1-82 89 
6 16-JU1-82 92 
8 16-Jul-82 98 

4 16-Jul-82 106 
4 16-Jul-82 110 
6 16-JU1-82 114 

14 16-JU1-82 120 

87 14-Jun-82 134 

87 14-Jun-82 221 

21 16-Jun-82 308 

21 16-Jun-82 329 

38 27-Jan-82 350 

38 27-Jan-82 388 

78 28-Jan-82 426 

77 27-Jan-82 504 

18 18-May-82 581 

40 13-Sep-82 599 

641 639 

ed/in~dir>, 639 blocks 



512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 
512 



Codef ile 
Codef ile 
Codefile 
Textf ile 
Textf ile 
Textf ile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Textf ile 
Textf ile 
Textf ile 
Textf ile 
Textf ile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Codefile 
Textf ile 
Textfile 



used, 641 unused, 

641 in largest 
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TERMINAL CONFIGURATION FILES: 



The following preconf igured files may be used to configure the 
p-System for the specified terminals. The key assignments for 
these terminals are also presented in tables. 



Terminal: 

TeleVideo 925/950 

TeleVideo 912C/920C 

DEC VT52 

ANSI Standard Term 
(DEC VT100 series) 

Heath H19 
SOROC IQ120 



change file to 
SYSTEM. MISCINFO 

TV925.MISCINFO 

TV912. MISCINFO 

VT52. MISCINFO 



install GOTOXY in 
SYSTEM. PASCAL 

TV925. GOTO. CODE 

TV9 2 5. GOTO. CODE 

VT5 2. GOTO. CODE 



ANSI. MISCINFO ANSI GOTOXY. CODE 

(note also that ANSI. CODE must be 
installed in SYSTEM. PASCAL to replace 
the existing SCREENOPS routines) 



H19. MISCINFO 
IQ120. MISCINFO 



VT5 2. GOTO. CODE 
TV925. GOTO. CODE 



DELETE KEY 
INSERT KEY 



KEYBOARD ASSIGNMENTS 



Terminals: 



EDITOR ACCEPT KEY 

EDITOR ESCAPE KEY 

EDITOR EXCHANGE - 

EDITOR EXCHANGE - 

KEY FOR BREAK 

KEY FOR FLUSH 

KEY FOR STOP 

KEY TO ALPHA LOCK 

KEY TO DELETE CHARACTER 

KEY TO DELETE LINE 

KEY TO END FILE 

KEY TO MOVE CURSOR DOWN 

KEY TO MOVE CURSOR LEFT 

KEY TO MOVE CURSOR RIGHT 

KEY TO MOVE CURSOR UP 



TV912C,TV920C 
TV925,TV950: 



Ctrl C 
ESC ESC 
CHAR DELETE 
CHAR INSERT 
Ctrl @ 
Ctrl F 
Ctrl S 
Ctrl R 
BACKSPACE 
DEL 

Ctrl C 
down arrow 
left arrow 
right arrow 
up arrow 



ANSI 

Standard: 

(VT 100 series) 

Ctrl C 

ESC ESC 

Ctrl D 

Ctrl E 

NUL (see note 1) 

Ctrl F 

Ctrl S 

Ctrl R 

BACKSPACE 

DELETE 

Ctrl C 

down arrow 

left arrow 

right arrow 

up arrow 



Note 1: Determine which key will generate the NUL ASCII value. 

On the VT102 this is Ctrl space. On some terminals this 
is Ctrl @, This may be changed with SETUP. 
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DELETE KEY 
INSERT KEY 



Terminals: 



EDITOR ACCEPT KEY 

EDITOR ESCAPE KEY 

EDITOR EXCHANGE - 

EDITOR EXCHANGE - 

KEY FOR BREAK 

KEY FOR FLUSH 

KEY FOR STOP 

KEY TO ALPHA LOCK 

KEY TO DELETE CHARACTER 

KEY TO DELETE LINE 

KEY TO END FILE 

KEY TO MOVE CURSOR DOWN 

KEY TO MOVE CURSOR LEFT 

KEY TO MOVE CURSOR RIGHT 

KEY TO MOVE CURSOR UP 



VT52: 



Ctrl C 
ESC ESC 
Ctrl D 
Ctrl E 
Ctrl space 
Ctrl F 
Ctrl S 
Ctrl R 
BACKSPACE 
DELETE 
Ctrl C 
down arrow 
left arrow 
right arrow 
up arrow 



Heath H19 
(Note 2) 

Ctrl C 
ESC ESC 
Ctrl D 
Ctrl E 
Ctrl @ 
Ctrl F 
Ctrl S 



Ctrl R 
BACKSPACE 
DELETE 
Ctrl C 
down arrow 
left arrow 
right arrow 
up arrow 



Note 2: Consider using the Keypad Shifted option so that the 
shift key is not necessary when using the arrow keys 



DELETE KEY 
INSERT KEY 



Terminals: 

EDITOR ACCEPT KEY 

EDITOR ESCAPE KEY 

EDITOR EXCHANGE - 

EDITOR EXCHANGE - 

KEY FOR BREAK 

KEY FOR FLUSH 

KEY FOR STOP 

KEY TO ALPHA LOCK 

KEY TO DELETE CHARACTER 

KEY TO DELETE LINE 

KEY TO END FILE 

KEY TO MOVE CURSOR DOWN 

KEY TO MOVE CURSOR LEFT 

KEY TO MOVE CURSOR RIGHT 

KEY TO MOVE CURSOR UP 



IQ120: 

Ctrl C 

ESC 

Ctrl D 

Ctrl E 

Ctrl underline 

Ctrl F 

Ctrl S 

Ctrl R 

BACKSPACE 

DELETE 

Ctrl C 

down arrow 

left arrow 

right arrow 

up arrow 
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CURRENT UCSD P-SYSTEM BUGS: 

During final checkout several bugs with p-System Software were found 
which have not yet been corrected. SAGE will make available the 
corrections to these problems as soon as solutions have been 
developed or fixes are made available from Softech Microsystems. 

1. 68000 Assembler sometimes generates bad code file. 

The 68000 assembler generates a bad code file format when the code 
exactly fills a two block area. The symptom is the output of a 'Bad 
Procedure Dictionary' message by the Linker. The problem may be 
temporarily overcome by adding an extra word of code to avoid the 
exact boundry condition. 

2. 68000 Assembler generates bad relocation information. 

In the case where a value is formed containing the difference 
between two program labels, the value should be absolute no matter 
where the code is placed. The assembler generates erroneous 
relocation information indicating that the value should be modified 
when the program is loaded by the p-System Interpreter. The value 
generated in the actual code area is correct so the BIOS or other 
non-Linked and Compressed programs will never see the problem. The 
problem is only experienced by programs which are Linked and loaded 
with p-code or are Compressed (for pure stand alone application) . 

3. 68000 Assembler problems with .ABSOLUTE directive. 

The .ABSOLUTE directive should be avoided with the 68000 version 
Assembler. All normal program counter relative addresses (program 
labels) are treated as absolute values which causes problems with 
Branch instructions and other instructions which assemble 
differently with absolute vs relative addressing. 

4. YALOE causes Stack Overflow in Extended Memory system. 

The non screen oriented editor, YALOE, causes a Stack Overflow when 
reading in a file in the normal SAGE II Extended Memory (separate 
code and data) environment. If YALOE must be used, the SETUP 
program may be used to configure a SYSTEM. MISCINFO which will boot 
up with a non Extended Memory environment. This is done by setting 
the Code Pool Address (high and low parts) to zero as well as 
setting the Has Extended Memory field to FALSE. 

5. {$D+} compiler option causes Backend Error 30. 

The current Pascal compiler causes an error during the second pass 
when used with the {$D+} option for symbolic debugging. 
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6. Long files cause the Editor to crash. 

Reading in a long file (>66 blocks) will crash the screen Editor. 

7. Problems with Adventure program in USUS distribution. 

The Adventure program in the USUS Library has two problems when used 
on a SAGE II system. The first seems to be a recent change to the 
operating system which does not handle the end of file condition 
properly. It causes an error "Ring Buffer Overflow" when reading in 
the data files for the Adventure initialization program. The error 
may be avoided by removing the last carriage return at the end of 
each of the textual data files. 

The second problem is actually a bug in the Adventure program which 
did not show up in pre-version IV systems. Unfortunately it causes 
various Exception errors (Address Errors, Bus Errors, and even RAM 
Parity errors) . The program defines two records (ARYS & VARYS) on 
the heap and then reads data into them with a BLOCKREAD. The amount 
of data read exceeds the size of the records thus overwriting 
something in the Heap area beyond the allocated records. In older 
versions of the p-*£>ystem the Heap had a simpler allocation and 
nothing of value Was ever overwritten. The solution is to allocate 
more room in the two records and revise the calculation for the 
amount of data read into the records. 

8. BOOTER transfers all of first track. 

The p-System utility routine BOOTER transfers all of the first track 
(8 blocks) instead of the first two blocks thus wiping out the 
previous directory. For the SAGE II, the SAGEUTIL program should be 
used for transfering bootstraps. 

9. Update required to final Version IV. 1 files. 

Softech has not provided a final release of the Version IV. 1 system. 
When this release is received SAGE will update your system with the 
final files. Also the Print Spooler, currently missing from the 
distribution, will be provided. 
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